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ABSTRACT 

This document describes the LOGO system, implemented for the POP 11/45 at 
the W.I.T. Artificial Intel"! igence Laboratory, The "system 1 " includes rvOt 
only the LOGO evaluator, but also a dedicated time-Sharing system which 
services about a dozen users, Tnere are also various special devices such 
as robot turtles* tone generators b and CRT displays. 



This report describes research done at the Artificial Intelligence Laboratory of 
the Massachusetts Institute of Technology. Support for the laboratory's educa- 
tion research is provided in part by the National Science Foundation under 
grant GJ-1049. 



]. INTRODUCTION 
This oocutienl daacribea the LOW lyste" inplenanted for the PCP 1 1 fVi at 
the n. ] . T. Artificial [nt*l I igecice Laooratc-ry. The "Byatam" Include* not 
only tha LOCO evaluate^ but al^o 3 dedicated tirre-aharing sullen unithi 
services about a doien use* a. Ther* ar* also various special device) "UCt> 
as robot turtles, lone gen*ralors, and CRT dipping* 

" : I *-' "~1 -'- '-ey n -J ; "f' s.^k .!i!>:-. ,'imcr!, T H i 3 n-ii'.al is 

intended only a* a language description- and riot in a primer. Ue hnpe II 
u! 1 1 be useful as a reference far yjers of our agate" and aa a source of 
comparison foi- users of pther LOCO systems, Secondly, wt believe that the 
syntactic details at a conpyter language- are of inaigriif icant important* 
corpparad to const deration! of hou the language ia uied. Anyone uho read* 
this paper to fins' out "what LOGO ia like" should not niylacl the papers of 
Papert and Solomon. Finally, the LOGO language ra part of am ongoing 
research project. 1 1 i j to b* ful lu expected that the language 
specifications nil I change uitti our experience, 

Uhi l( there hive bean nunerous contributor* to the development of 
the LGGD language thona specifically concerned with the POP 11 
I TO I e*en t a t i on are: 

FtonUbel, tlne-B-tiaring system Uadt Ui 1 1 ia»B, LOCO evaluatort Jm 
Cohen, ti*ie-sharing i nput /output; Nat Goodman and Hal Ado I son > d lap I! ay; and 
muiiic box; Ron Leoel and Roger Hale, filing agiten. Aa part nf the FfFll 
programHing; project hb have developed 3 POP 11 debugging progran which ia 
similar out nore poi*erful than DEC h s DDT program. Thi* "3s done oy Radia 
Per I Kin* fcjr display control I er uaa dGsigned and built Py Ton Enight. 



Ttisrs is also fln tssential ly conpafiblo LOGO" evaluHor which has betn 
implemented in 01.1, T»'< viralon off USP by ka ColdfltBln and Henry 
Li chef nan. Ue nujt also cile th* contribution* of Richard Drpcnfclatl cm 
^altera of ayslfih da-sign and, of -ccnjrBe H Seyiiour Pfl^ert and Cyntnia Solomon 
on language specification. , . 

Hal Abel son 
Nat Condnan 
Lee Rudolph 



2, BASICS 

Thie section introduces seme basic LOGO vocabulary. LOGO 
eta tenant a zr 9 typ*d In at the eunaola. You type a I in* of inatruct icnt 
and the computer a^cutes it lor type* an Hirer meeaagah Th« computer 
indicates that it is ready for an- i no true t i pr» tiy typing a question mark. 
Your line of instruct inns, will not be aaecuted until you end the | rna by 
typing p «rn)g fl return. 

The basic "built-in" uorda that lh» ennputer understandf art caHad 
LOGO crini t ivea , Theae art dej^ibad in this nanus I . The host inportant 
primitive It TO. which allows you to teach the. computer nau worda. These 
private uordfl that you teach (he computer are called procedures . 

Primitives and procedure* of tan tafce one or sera influta . For 
e*aht?te, P^i 3NT i-a a primitive yh L ch take* ^ha input and printa 1 1 Oft the 
conaal e. 

Pfl]NT la an evanple pf a connand . A comeand it an Imperative. It 
tel Is the computer to do something, 

D!h e r prinltives nay output . They provide I value which can be 
U*ed a& an input for another LOGO iwrd, SLM l for examole H takes tuo 

I- 

numeric impute and outputs their sua, Procedures teiich output an called 
OfftrationE, , ■ 

All complete UXO ataTement* are tuperat i vea, it) that an operation 
cannot Bland cy itaeJf. |f you type; 

zjr 17 2G 
LOGO will respond uith the error atttaga; 

YDU DON'T SAY UHftT IP DO UJHH 43, 



in ccnfaslL 

PR] NT SUA 17 3G 

it a enrnp-lete ata!e*ient. The cotiputer ul I I print 43 H 

Tf you *iaka a typing. niflta*e yau c»n press the "delfl^i" or "rubnut" 

kcy + Thi* causes LDCd lo ignore the p^cwicue character. ]t indicatea this 

toy retyping th* ignored character with slsahee around it. Preteing rubnut 

again ul I J cause LCOO to ignore the character before that, ind bd on. 

Another feature i* tha "panic button" ctl-C [control G] . Typing ctl-G 

in tha niddle -pf ? coHriand line causes the entire line to be ignored. 

Typing ctl-C utii| B LOGO is enfroiting a cornnand Causes it tp atop 3rd 

returns control to the teletype. This, ra especially useful it you urite 

procedures Khieh do not stop py thenselvea. 

Note: The "ctf key is like 
3 shift key, En order to 
type cU-G, hDid :i?un the 
"ctf key ami type G. In 
this tianual ue ao*e tines 
vse * to indicate "control." 
Thus *C stands far control G> 

Soae pe ir»ttives tiave aobrevrat iona, U you type the ebfcr*v-| at ion as. 

part of a procedure lina, UOTitt ui It expand it to the full forn. 



3 . DEF r N E NG AND EDI T L HE LOCO PHOCEDUHES 
3,1 TQ and EDTT Abbreviated EDI 

Both coiinandj Dul you intD editing iFods, Their input* ars 
restricted as f&llgus: 

i) No LQuD prrkjtivBS 
■ i) Far ED[T— ©jib inout h ^h* natie :?* .1 nrgceoure 
which Is already dafined 
ISU For TO— warlflfclt nuhtwr of Input?: #1 I but 

the first art dunr»y variafclei uhicn stand 

■ 

for aventual inputs to the nail prDCfiCKir*; 
the first input nay 6b any narte ilhlch it 
not afreatfy the nam of a procedure. 
Far npre on Inputs, saa'Sactlpn 3-7 oelou. 

3*2 END 

Take* you out <?f editing mode- 

3,3 RESTRICTIONS IN EOHiNG »GC€ 

Ubita yoy art def ming/edit ing a urocadura you can still do most 
of the Ihingjs you usual lu can do in the LOCO uoMdf uas a display T a 
turtle, a tiujlc bo*, or pther dsvica; evaluate prceadures— Even the en*, you 
are in the aidst Of daf ining^edi t lr>g< tto<WBver H uou canitpj daflne/edit any 
othgr prpcedu^-e . That is, TO and EDIT" are invalid! camnandi once you are in 
editing Binde. 



3,4 THE EDIT DIFFER 

Lines you ',ytc pSss mto tht procedure 4« f Ini t i nn v i a an edl t 

bgfler. A I 'me is put into the edit Suffer if the first word on thr line 

is a line nurrDer la uncle number greater that 6 and lama than 327GS) r 1 + a 

lint nui**jer it not present, uhat ycu type in will be regarded as standard 

LOGO input, Hfth the above res tr i c t i ons . Every character and space you 

type after a fire nuti&er is put into the buffer until yon tunn a n,ir-'iaye 

return, (A machinB-eKscuted carriage return--Hhich happens automatically 

if you type too r»any characters on one line tor the console, or whatever, 

to accommodate— ddeftn't have this if f sell ■ The succeeding carriage return 

nil I than empty that buffer into the procedure definition 

Uarning: The buffer can only acccmiDdatfl 130 characters and abates, a 
little O'ver three line* on the leletype; putting In more than that 
uill jair tn'mgs up and 1 leave you no recourse but "G. 

'hree other uays to get things into the edit buffer are EH1T UNE. 
EDIT TITLE and "*. EDIT LINE [abbreviated EtLl b a single command deupi ts 
the space, takes one input, a line nurrier, and if that fine exists it i« 
put in the 6ufhar T EDIT TITLE (abbreviated ED T) take* no inputs, ar*d puts 
the title of the procedure yOw are defining into the buffer. *Y puts the 
previous, line you typed into the buffer (handy- if you for gut to type a line 
nutrher. *or exairplel . 

Uhen you have aoietTiing in the edit buffer,, you can manipulate it 
uith these Special control characters! 

J *C prints out and stores the neat character in the buffer 

- 

ti prints cut aid s far eg the next word 
^£ s*.ipe. — i.e., deletes the next word 



*fl prints out and stores ttie rest; and at any time Enot juat in 
editing mode] you can- u», besides the rubout or dwfate hay- uhidh deletes 
the previous charaelef. 

*U trfiich deletes the previous ward. 

3.5 ERASING 

Uhcn you are ripj in sditing mode. ERAS: [abbreviated EPI takes one 
mfjul, a procedure nane, and repaves that procedure froh your worh apace. 
Uhnn you are In editing node, it does Ihe sane, but you Jre rot allowed to 
ERASE the procedure you are deF i ning/edit ing, ]n (editing *ode only, you 
car ust the cetinand ERASE L[HE libbreylatsd ERU. Its input ia a I ins 
number •, and it erases That llnti 

3.6 PRINTING DUt 

Uhen you are not in td I ling 'nod?,. PRINTOUT (ebbrevipttrf POJ takes aa 
Input Sny procedure nana, and prin(t out the daf ini t i on uf that procedure. 
By default, If it ia given no inpgj it prrnU out the definition of the 
last procedure ynu defined or edited. Hian- you are in editing mode. It 
works the earner i t a= default input is the procedure you are 
de ( i n i ng/ed i t i ng, 

in editing node only, tha comnands PRthJlDUt LIME latobrevigted PCLJ and 
PRTHTOJT TITLE tabbraviated POTf can be used; tha first takes one input* a 
line number,, and prints out that I mat the aec-ghd t*>*e no inputs, and 
nrints out the title of (ha procedure peing adi*ad. Neither eomnand put* 
anything in the edit buffer. 



2.7 OLfiriY VARIABLES FOR IPRJT& 

Aflsr iU first input, TO can take further inputs nf the torn t*word>. 
each: o-f these stands for an rnpyt nhich ths defined pi-ocBdure up 11 have to 
be given, &M B*3*ples throughput the manual, 

3. ft PROCEDURES LH1CH EDIT PROOEDURES 

]t is possible to -J9B any nf the CffrniancfB. discussed aba** within 3 
LDG0 procedurB, They work trve sane, with a sing I* B*cFjption3 if the user T 
u&rKinfl at top I eve I H types ETC to finish defining: a prac.Bdure H LOCO 
repjiss F00 GEFlNfD (uhere FQO is the title.)* Th ibj is ntrt printed ovt uhsn 
the editlngi procedurea are called bu Other procedures: a great ccrwen ience* 

Note, however < that ths restrictions cf Section 3.3 aluauis Apply— you 
cannot hr d?f mrng nee than one procedure at l time, (Sea Sect I en 18+2 
for inorc data! Igl. 

3.9 C0mENT& 

Tb-kI Bnclosed between exclamation points or betusan an ewe lama t ion 
point and the end of th« 1 i™ is i-gnored and can be used for corxhents. 



4h LORDS f*m UST5 OF ugHDS 
<aA lords 

In LOCO strings of characlert irt called Hprda . A nord may he 
indicated by prefixing It uitb a quote, a a in: 

iPdim -lhdopie 

UhDOPlE 

The uord consists of all the characters between Ihe Q.UOI* and the 
fol lauing space. SA carriage return also terminate! norde.] Therefore a 
uncd may no* contain a space li sn« d( its Character*. 

The FRTNT eonriand (abbreviated PR] can bo used to print uordt a-t 

■ 

indicated aoe*e. PRINT takes one inpul and prints it fall cued by a 
carriage return, ft *eryj s ■ n i I air canmand It TYPE* trfiich acta, just like 
PR [NT except that it do» not include (ho carriage return. A uprd "ay 

include arty printing character except apace, carriage return and left and 

right 5rjud-c brackets I and ], J'n partPC(jlaT H a uord may- contain quotation 

marktl 

?PRWT "A* 
A r 

?PftWT "- 

■ 

A Mord may also contain no chariot era. Such 9 kord 1* tailed "the 
. e*pty unrd" and is Indicated by a Quote fol loued by no charactara: 

*>rini " 

A percent sign in a uorel It printed da a apace. T(\l e 1 3 uaeful in drawing 
patterne on the teletype, as 



TO BOX 

10 PRINT *X)O0<X 

28 FRtwr -scxm 

30 FP.INT "mi* 

4* print "mix 

58 PRINT "XKXKJf 

EIC 

?BttK 

XXXXX 

X X 

X X 

X X 

NXXKK 



**Z Lf&TS DF UORDS 

Ordered collect ions nf wqi-ds »e railed Mais , (LOCO alee jlloue 
(.ore general lists a, described In Chapter IS.) A II si may be Indicated by 
giving The tiarda in the I igf, separated by spaces and enclosed in squar* 
brackets. 

?PR[lfT [[ ATI * LIST] 

r AM A U5T 

Notice that the uordi in the I tat are net quoted and that the 
*u*r*unding bracket* are not printed. The spate* betueen the- words 9«rv S 
.only to eeparate the words and h strictly speaking are ne< tart D f the 

I i*t. Extra Spares are Ignored by LCGD: 

7PP.ENT [EjfTHA SPACES] 

EXT-'U BRACES 

A carriage r-i turn ulthina lie* is equivalent to a spa« f 

?PP]NT ITORE THAN 

BE 

LINE] 

ICflE THAW ONE LINE 

Gcir»fl aJqno uith the cmty yard •* ha™ th« etipty lift nhich, chi~ 
tains no u^rda: 



?PRIWT t J 

H^te that the ewpty ugrd if # ugrd and the empty list it a I ist and they 
are not the &ane. (See ll«o Section 4.5.3 

4.3 HAMPLUTJNG UQROS AND LISTS 

Thept gr* 3 fiuh&er of operations for Mnipul at ing words and lists: 

COLHT 

Takes one input. H tNi input is a word it CUtpUts the nurrtier of 
letters in the word, [f Xhw input is. a list it outputs the numper of words 
in the list. 

FIRST (abbreviated F) 

Takes one input. If the input is a unrd It caputs the first 
letter of the ngrd< If the input is a I I si It outputs the first word of 
the list. 

LAST (U 

Similar to FTflSr. Outputs the last Uttsr Iresp. uwrdJ or a unrd 
(resp, lr»t> 

WTFlftST iBFJ 

Outputs all but thfl first le-tter of a wrdt all Put the first u&rd 
of 3 I i st, 

HJTLA5T (BLI • 

Slull*- to fMFIAST, FIRST, LAST, BUrFIRST. and BUTLA5T noy ™i bs 
applied to the anpty uord or the shpty list. 

These operations t*a uorda and fiats apart. For putting thea 



together ue ha^et 

IBRD 

Takes too inputs, both at nMch mtai tit words and puts then 
together to make 5 longe- uord* 

?pRiNr WW3 "wu 'here 

MDMHERE 

SENTENCE (abbreviated SE) 

Takes tm inputs, ]f bam an 4 ista it put* the* together to tiak« 
P lor»a.BT list, [f pn» is sward and one is. a Mat it adds, the uord to the 
list, ]f both ar« wordB- rt makes a list out 0* the*: 

SENTENCE (THIS IS] [ft LIST] output* [THIS tS A LIST] 
SENTENCE 'hANSO "CHITNEV outputs [HANGO CHUINEVJ 
SENTENCE IflATH IS) "VECCH output a tltftTH 15 VECOfl 



Exariple; 



TO REPLACE :LET iLl :L2 

10 IF [LET - :H OUTPUT -L2 ELSE CUFPUT tLET 
EM) 

TO LISP :U 

11 IF tU - n OUTPUT- * 

20 OUTPUT UQRO REPLACE F|*ST :U "S "TU LISP BUTFlfiST :U 
END 

TO hULT[L]SP :S 

18 Jf :S - [ ] OUTPUT [ J 

£0 OUTPUT SEWTEflCE LTSP FIRST :S MULTILTSP BLITFIRST :S 

END 

?FfilNT PTULTTLISP [THIS IS A RECURS] *E PROCESS] 
THITH tTH h ^ECLRTH]YE RRDCETHTH 



A A REOLe&T AND TfPEJNt nULTIPLE [NPUTS 

The LOCO Dpersllcm flEQUEST uaits for the user to typ* ifl a lint and 
then outputs that list. 



Tfj AGREE 

10 print [Type swethii* m likej 
20-ph1mt isewtehi [| l1kej feouest [tdq] » 
e«d 

?AGHE£ 

t\Pz RmFTHiun yoj like 

FICKLE JELLC WPH FEW4UT BUTTER 

J LIKE PICKLE JELLO LJ1TH PEAHIT BUTTER TOO 

Jn tha above ewanplfl (ha prohpt character > indicate* that LOCO is 
waiting for a FEilLEIT to be -typed in. The liat typed into a BEQUEST ja riot 
Enclosed in brackets, and Is terminated by a carriage-re turn. 

The above. e*aapie also Illustrates that the SENTENCE operation can 

be nade to take more than (ho inputs try enclosing lh B unrd SENTENCE and a I I 

the inputs in parentheses. SENTENCE th*n oo*bln« all thej inputs into ona 

liet. UORTj, PRINT and TVPf car. al ? g t?k« rnylflpie Inputs in this uay. 

Notti Oo not confuse p*r-en'heses a^d 

square fackets. ^aren'hesss indicate 
grouping of inputt. Square brackets 
are nore like quotation Tarks. They 
1 0(1 1 c^t? th^1 !--n!:"-ing Is to be takefi 
I i teral I u. as a I rat. 

REQUEST aluays put put i a lift* tvtn It it *S a I ■*■* containing one 

f.a- noJ words. The operation TVPEINJ is like PEGLEST accept that it output* 

a word, TYPE1H is equivalent to FIRST of flEOJEST, 

4.5 FFnlHT 

Order the LfJCO printing :on*ontiona the ehpty uord antf the empty 
list both print as a blank line. Likeuise a n;-d arid a ona-Nord list print 
tbe &ama: 

7PRJNT 'UMBLE 

nuriBLE 

?PH1NT [HJ1BLEJ 
rTuhfiLE 



While thu it convenient for writing corwtr-t#| ional progr 3.113 il cSn 
a I so b* mi (leading, especially uhen [racking four's buga which may come from 
confuaing i»rds and Mat*. To h lp hare, LDCO provides the conriand FPRINT 
("Full PR] NT* I uhich ia juat I »k« PR[flT incept that it prints (he brackets 
surrounding I lets, 

7F Q R]NT [MlinajE] 

[n.ireLE} 



5. MTOERS AND ARlTHEUC 

5.1 [NTEGEH5 

The lar^eit integer that is accepled by LOGO arl|hh B tic Ih 
2,H7h*B3,6*7. The anal lest nuliber it -2,147.4G3.547< !Note H hDuever. 
thai nymberB are arittan in LOGO uithout cornet,) 

5.2 INFJX fDRIIS 

Each of the baslt arithmetic opera I ions has an infix form IjMr* 
because the symbol goes bgtue'en (ha operands)* 
+ f or add i t i on 1+2 

- for auto | faction, 1-2 

* for- multiplication, 1*2 

f for the quotient of integer division* 3/4 outputs B 

\ for the renainijer of integer division. 3\4 outputs 3 

- fof unary. mhnu*. (This is not technical lyj in irifiw operator, but 
it* use ia effectively th« sain ae u* ironing the operand from zero, t 

5.3 PflECEDir^E 

*,Aand \ have a higher precedence than * and -: that means that 
* h / h and \ are evaluated before + ahrf -: 

7PRJNT 4*5 -4*5 

is equivalent Jo 
7PH3NT (4*5) -H*5] 

23 - 14*53 

29 - 29 

e 
e 

At opposed to 



4* 1 *6 

20 
20 



All theaa infljn operators have higher pr*eadenca than pref!* ocias which it 
uhy all the arithmetic gate dona bafws any FfllNTir*g happens. 

5,4 NLTIERECAL CONDITIONALS 

< + > , and * are- Infix fnrna of opera! i«na that compai-a two 
numders* < neana "less'- < output* TfiUE if th# fir** nuBbar is lei* than 
the ae-condi, FALSE other-dine. - mi*5n* "equal". > naina "greater". 

Thr^r: nark in ].ir. sant narmer as <: : 
TPfliNf LQB - IBB 

true 

?PP1HT 109 > IBB 
FALSE 

< . > H aid - have loner precedence than ]h* etfiar arithmetic 
oper a t i Pfla , ao unao per fording a corparl H-un \h^ arithmetic is dpne tirat. 
Thasa operations are usual lg u*ed with the LOGO ccndl t i ona La . IF arm! TEST 
Isre Chapter 9) H 

< and > raqyir* that thalr input* be nunhera* 

"WPLE > "PEAfl 

ia ccn^idered nonsense and Mill generate an error. 

■ » tiQua-var, can ne u?e<f to compare any two LOCO objects. For example* 

TOOEV - "FDOEf 

daea frak* aenae and Hi M work. 



5.5 prefix Fcnre 

Each of the arithhotic operations has a prefix fern {prefix Uecause 
it cones be'o-e (hs ops-andsh 

surt + 

DIFFERENCE 
PRODUCT * 

QUOTIENT / 

R01A1NDER \ 

GREATER > 

LE55 < 

EQUAL 
■ 

SUA an^ FPQTJUCT make ubb of the variably nuhhfjr p f inputs feature 

(see Sect inn ^.41. ■ 

?FR[NT rSUI 3G) 

?PREKT (SUT 1 Z 3 4 & 6 7 I 
23 

5hE RANDPn 

Takes no input*, outputs a a ingle digit randon integer, 

■ 

5-7 FLCATrfJG POINT NUflBERS 

]n addition to the integer nuneric fori already nent ione-d, LOGO 
also accepts floating point ngng(rs H Tneea niyhhera can de ewpr eased In iua 
different formats for both Input 3rd output . These forms are Standard 
decimal notation and exponent ill notation. Exponential notation It of th* 
ffll Fpu ing f ormj 

<numoerj*£ or N*«eifDDnent> 
where <nui&er> Coal ltd the nantisaa) is either a floating point nunfcef In 
Standard decimal forfi or an ntsgs'-, a n d <exponent> ie an integer 



(represenl infl a Pohbt of 1BI . ]! 1h* exponent is poeitpve;* the I at lee E Is 
u«S t* seuaralB the nuwOer fro* its environ t 1 if the exponent is negative, 
the letter N !« vied. There ghuutd be no spacee Petueen these three 
elenents of exponential notation. For decimal notation, a nurr.per is 
uritten In aSmost the sarn* ror* a? an integer > bul there mm! be 3: decimal 
point at scne position in the nunher. If this decimal point 1b not 
present* the muster nil I be regarded as an rnteger h Here are gome sharpies 
of valid Moating pa-inj rtynbera in enponant i al forna 



3E4 


5N2 


3.4K 


4 r 5G3N3 


-4E4 


-4N5 


-2,532SE9 


-25&255NZ 



ThB following are not in correct exponential for*: 

3E&. 1 (The exponent It not an integer) 

Zh7E-1 (Tha letter should b* M 

IB El \ There Should be no epacel 

The following numbers are axanplag nf flatting point number* in 
dec Ins I notation: 

4.S6 
2-59,259 
. BeBBaeaazBa 

The output 0^ 3 floating point mmoer- ui M aluayj he In on* of 
these tug formats* Usually the output hi 1 1 be in decinal notation uitn 
non-£lgnr Meant and trailing zeros renewed* If the nukber is too large or 
too Small to dc rBprBSB"tad with 7 digits end a de-;irial point, it will be 
aulohat leal ly converted to exponent i a I notation (tilth one digit of the 
nantissa to the left of the decimal point). The ma*imur» nagn! lud** ui a 
floating point nunfcer 1" LOGO 1? approximately 1.7B1&E33. The riininun 
magnitude If 3WjroKc|i»t*iLi 2. 9387N39 (however, this cannot be enured fro* 



a con-Bole-- the g™,jl ie*t nsgniluoe that can be given as inttul la LOGO i) 
LH38-]. These liming are the sMe far both positive and negative nurtbers, 
All ari|h«elic operationa an floating point numbers yield floating 
point mjubBf*^ In order tD force conversion of a floating point npynfter to 
an fltte-gsr* the INIECfifl operation is- used, fNtEGER late 9 one inputs a 
floating point nutrber in decira) or exponential forn, and output? ihij 
number converted 10 in inleyer. [Reneribe^ houever, that INTEGER r-s subject 
te the standard LDGO limtt on Integer size, and conversion ol floating 
t>olnt numbers exceeding thia -bIzb u.i-1 I f J< U In order lo lerce the 
Conversion of an integer to a floating point nuabtr, eimplij multiply by l.» 

£.B NUMBERS AS HMJS 

Nutibers are eonaidered ta be LUGO wards Isee Chapter 4}; all uord- 

lifi-jla^ing operations uork, on murberB, toor 

■ ?PH|NT FIRST 4K73 
4 

?PH]NT BlfTFIRSI 45578 
5G7& 

TfRINT [UOflG 1Z 34} + (UORD SE 781 
G912 

Integers- or Moating point nunbtr* e*C«ding their respective »iie 

I in its are still treated 1b nOrd» bul ewmol h* u«d In -arithmetic Ew*n 

though number s are words they do not have to be owO'ed when typed in. 

5.9 NUTIBERP 

Takes one input- [f the input is a number in the allwabl* r jingo 
for its 1-ft*B*ctlw* typ*, NUTBEHP output? TRUE. Ef the input it a numjar 
outside that range, or i a n' t a nuhber at all, NUHBERP output* FALSE. 



G, ARRAYS 
Arrays in. LOGO ire D f one, luo or three dlhcnsione. There are 
thr« Types of arrays-- intB-gar. flNllng point* and pointer- 

E.l OEFIHEARRAV 

To Create an array, the conmand DEF]r£APFAV (abbreviated DEFflRI 1 9 
used. Depending on the nunber of diftsnaiona. OEF]NEMfl*Y takes up to five 
input a: the narn c of the array, the dimension* of the array , and the array 
type Stf for lnt*gai>.l lor figging point. 2 for pointer I. ]f Ihe array] 
naa fiore thart one d i nerva i on , tha cowiand C€F[NEAW,AY and lis input* must be 
enclosed in parenl hn-sas. 

S.2 AflRAY SIZE 8ftd SPADE ALLOCATION 

The ma* prut slEt of arrays is Sftpendent upon thi Current amount of 
array 5paca r Arra^ space i a normally 3! located Ho ailou approximately ZS00 
ele*icn|» in pointer arrays h and half Chi b anount In Integer and ffoatingi 
point arrays^ The total anouit of space used U appropriate I y eousl to the 
but of the number of eJemehls in each arriy, with pointer array elements 
only uimp half aa much space as integer am) floating point. THouever h It 
should b« noted that every tins an array ig created SDne «K!rj space is 
used to store the description of that array, flaking it more efficient 
regarding space to use single Jarge arrays uhenever possible J 

It i* possible to »1 locate W.ra g.pdce for arrays by using the 
SETASI2E cCHhand. SETAEJZE takes one argument. Ihe amount of Spats to be 
allocated t in ucrdi (every nc-d stores one pointer array element. every two 



Htirds stares o™ integer Or Moating point array eleroentl. The nanitiun 
input to SETA5EZE is appro* inalely 11800, Hhich irakaa it poaaibla to e*pa-nd 
grray spacB by 3 taelor of thraa. One inpartant note about SET AS I ZE — thfl 
utt of this comnand involves a re-ini t ial rjat ion ot the sire of (he user' » 
workspace, uhich rieana that i nuu "UELCOflE TO ULOGQ" nessaga Hill be 
printed upon couplet ion of the cornand. Thus, any use of 5ETA31ZE should 
be invoked before usingi (h« filing ayatea in order to sa^a the trouble of 
Having to read files again, elc. 

Arrays are not saved in the filing •Byaten' Isea Section lL.t!, They 
are autnfc&Heal ly erased uhen you type HELLD or GOODBYE to LOGO, and so 
th»\J KUSl be re -created each I sue- you use LOCO. nDuevEr, they can be 
r-..!0'.'d *• .in .j inn :-rij ',.r. r- 'he :r-inan-2 E^A^E ftHHAf' tabe'evi atec E& AHHAYI . 
This GomFiand takes as input an ar-ay naite and erases M fron your uerkspac* 
(see Section IB. 21. The cornand ERASE ARRAV5 1EH A.RRAV&) taken no inputs 
and erases all arrays fron your workspace 

E.3 GET and STORE 

ilhen an array is- created, all the eifatfttf ir* t«1 to ze^O+ |n 
order to assign values to specific el orients of (he array, the STORE coi»*and 
ie used. GET is - an operation used to referent* thf **lye of 9 <pe-c i F i t 
♦lament. STQ3E takes the sane numoer of inputs aj th* correspond! no 
DEFINEaRflAV coiHiantf; its inputs In order aret the array nit**, th? 
coordinates of the desired tlenant, and the valua to be assigned to the 
element. GET takes one lass, input than the corresponding £ TOPE comnandi 
its inputs aret the array natie, and the. coordinates of the desired elenent. 



Unl.ihB STORE and DBF immt, GET output* a * fl | U(h A* in TJEF I NEAnRAY f C£T 

antf STORE ar* lh B i r relative inputs «u«t be andosed in parentheses if 

the array is of more than s?n B dimension. 

ft is iip<kr|an,t Ig renenbar in using the GET *nd STORE Deration* 

that LOGO <j*ee e-orlflini inde«ing + L t . tor any dimension of lan^h n, the 
dements art nU r*are<| 3 to n-h For exMpla, In* fourth tlehent in 9 
ting Ib dimension acr^ f a gi^en coordinate nurttoer 3; the et^ant in the 
fourth ran. fri rd col ufM cC a \ua. dimensional array FOQ it addressed TOO 
3 2 ; and $0 on. 

6.4 PRtHTirjC OUT ARRAYS 

ASIZE is an qwrtflon which Takes one input, an array nan? 
[quoted) . and outputs the d mention* c f the array. The eormand PRINTOUT 
ARflAY (RQ ARRAY) t*.« 39 input an amy nama and pr i ntl out ita typa and 
dlHHsions. PHINTQUf ARRAYS [TO ARRAYS] takes no inputs and tarrock PO 
AflRAY for all array, cur en t I y da fined i r> your uork apace. 

Ewatipfes of array operations: 

?fDEFAR "& Z 2 61 
?Pfl (GET h B 1 1| 

7 (STORE *fi 1 1 71 
PR 4CET ri B I 1) 

7 

?PR HCET "B i 21 

INDEX REFERENCE OUT DT BOUNDS 
^OEFAR -fl J000 

NOT ENOUGH ARRAY SPACE 
?5ETAS)Zt E3B0 



UELOOME TO L3LOGO 
?OEFAH "A im 9 
?PO ARRAYS 

* size zees tvpe integer 



7. NAflENG 

7.1 rake 

The LOCO co*nar*l flAKE ie used Hjr naning. F1AKE taki?, -tmj input at 
IhE first is the name and the neond is th* thing bw : rg narnsd. 

HAKE "X Z7 
will assign the flaw* K to 27, A narn fcuat be a LOCO i»ord {see beet 5 on 4,1 
about uords)* Z7 ra the value er' thing, and ray be » ryntjsr or a nord or a 
list or anything vise. 

The uae of (he synbol : [pronouficEd 'dots"} as a Br*fi* to a word 
retriewea the thing or value of a uwd, 

7PRJNT |K 

27 

TtlAKE "HV2 27 

[The M*rE) (The THINE! 

7PHINT tKYZ 
27 

THEM; \t an expliei t LOCO primitive that dots uhlt i doea, i .e. t it 

extract* the- thing fram a word* 

■ 

?PRJ*IT THINE H K« 

27 

?rt*KE "RABBIT "HARE 

?PR]NT : RABBIT 

HARE 

7PRINT THING :RA3BIT 

ulll gervjrate an error h because tho word HARE hJI Pfl thing. 

Let's give HARE a *alue; 

TflAKE "HARE tfi B CI 
7FRINT tHAKE 
tt B CI 



fair. 



7PRINT THthlG iflABBIT 
LA 6 CI 



Thi ftackarrau gynool {*| i* in infi* fori of flAtfE 

7*tiAt% 4- h REAUlArt 
7:N*nE * 27 
7PFIINT tREALMATt 

:- 

?<UGR0 "REAL "NAHEI ♦■ 27 

uarka, ton. 5a does.: 

7-MUrt 4- 9 

7OJ0HD "AHffAV tWJI] - 'ROSE 

iFRFNT THING lUCRO "ARRAlf iHUTI] 

ADSE 



3r is a I ed passible to uaa the MAKE connand to give duktipift na*ea 
to the sane value. This- is dona in tha following Banners to givi JiJO namea 
A and the sane v«lut, u* »*j 
"A 4-"B *«wtUI* 

Thus can be done* for an arbitrary nunber of nana a- {subject o^lij to 
thi limitation on the length af one line in LDGOh . Multiple F»A^E c3n bo 
bartortnndi onS^ uith the infi* torn gf the flAKE camnand [■•-]. 

■ 
7 + Z LOCAL AND GLOBAL NArES 

The inputs to a proceduro are local nanea, that i*, the nane. Le the 
procedure' a owr* private nift*H Fo<* e*anp|*i 

?T0 IV !* 

*18 WXf "A tA+1 
>?0 PRINT :A 
>FJJD 

:n: defined 

7T1AKE d k 3 
?!NC 3 

?Pfl]NT :A 
3 



[n the aba^e sample, the name A in tha procedure haa nothing to da 
uith th* nane ft al fcha top level, 

]rc contrast, names uhich are not inputa to a prccediure «r» global . 
Cotrfjara uFth the previous CKaitplw, 

?T0 INC 

>1B nm *h 3A*1 

>20 PR] HI :A 

5-EHB 

[NC DEFJHED 

7PAKE 'A 3 

7IHC 

4 

?PF?l»n :A 

4 

Both uses of ft refer t* the s#ne global variable. 

ll is passible to taupe a nana to be local ta a procedure even If 
It in nnt an Input, This is done uith the LOCAL wniiand. LOCAL taKeg one 
input, I he nan* to be declared local* 

Examples 

TO CDUWTSQL r flR£3 t* 

19 tf ix .e stop 

2B riftKE "X5Q :K • :H 

30 OOUfTTSaUfiRES ;X-1 

4B FHIWT ]X5Q 

END 

7lCUNT5CLI^E5 4 

1 

1 

1 

1 

Here XSQ is a local variably, Conpar* with 
TO CCIATSCUASE5 :X 

s local -y.zn 
ie tf «x-& stop 

20 ?1*KE "XSQ iX * sX 
30 CnUNrSQUlAReS :X-1 
40 PH1NT ;XSO 
EH 



7C01MT SQUARES i 

1 

4 

3 
IS 

Hers each invocation of countaquarea has i ta «jn XSQ. 

Nama local in a procedure are defined in that proee-diire and in all 

&utiprc:edure5 Sunless the audprocedure has i la oun Inea! version of the 

Bane- nanta) . 



S. CONTRHI 

e.i GO 

This cDiTTianfl hust be par? pf a precedes,. It tahea one Input, a 
MnE nunper i r» that procedure, and transfera control to that 1 1 n« 4 

fi. 2 STDP 

This also hftJongg in a procedure. It terftrnatea execution of a 
proeedgr* ah d returns control Id the calling procedure, 

a, 3 ToaevEL 

This returnt control in a procedure ian«didtBluj to the Kjp l«vaL 

SA OUTPUT 

This cornnand C3 r, Dn |y be UBisd in a proceduref it returns control to 
the calling procedure* and outputs ita argumnt. By using OUTFVT the u-aer 
c-Sn define procedures which ara- operations.. 



3, CONDITIONALS M-lTl HELAIED CfjrflANfJS 
3.1 Conditional -a are aptraliorij uhich output either "DRUE or FALSE. 
You can make your oun, if you u*nl + LOGO has three classes of roaoyroade 
Condi t inna let 

al Humeri cal condi t lonal*. e«g. LESS,. (See chapter 5.1 But note 
that ECUAL and •■ can als.o lake non -numeric inputs. 

tj| Logical Corid i 1 1 ona i a r These take inputs which evaluate 
eilher to TRE or to FALSE, and perforr logical operations on the*; thus 
they art used in conjunction ulth other conditionals. They are: 

KJTH-- takes two inputs; output* TRUE It both evaluate to 
TRUE, outputs FALSE if one or &olh evaluate lo FALSE.. 

El ThSFl— takes (mo Input*; output* TRUE If one or both 
evaluate to TRUE, outputs FALSE if both evaluate to FALSE. 

NOT— takes one input; output* TRUE if the input evaluates 
to FALSE i and wit* vtrian 

el Predicative conditionals. These see whether or not their 
inputs evaluate to a specified kind of thing. They fd 

UDROP— outputs TRUE il the inpul evaluate* to a word, 
FALSE otherwise. 

LISTP-- outputs TRUE if the input evaluate? lo a list. 
FALSE otheruiae. 

EhPTVP— outputs TRUE if the input evaluates either lo the 
empty, Ltord-or to th* wipty Mai, FALSE otTiarwiae. 

L ;LnjLl^ — utpuTE T-.Jr it '.[<<?. iiif;..it ^ v.ll.j.lli:-) \<;. P: r.imhcr, 
FAL5E Otherwise, 



E*amp I its; 

MAKE 'K ( J HAKE -I 37 

?Ffl[NT HCFQF :* 
FALSE 

?PfliNT L1STP iK 
TRUE. 

?PPJNT LtSTP iZ 
FALSE 

SPRINT EI1PTYP :X 
TRUE 

7PR1NT nUIBERP C0WT :K 
TRUE 

9.2 Conditionals can be iterated, that 1*. their inputs can be 
cantfi t tonal a: 

TO ANYOf jA :B :C 

Ifl OUTPUT EITHER :A EITHER :& tC 
Fhil 

TO 5TRCKE :A ,8 

18 OUTPUT EITHER BOTH :A MOT tB BOTH : fj NOT ; A 

STBtKE: P * rBfllh> "* B C * "* inae ^*d, if <fc.ired. Th„ y night clean u p 

i' 
1 8 OUTPUT EITHER (BOTH :A NOT B BJ [BOTH :B HOT : AJ 

Thare art alio a hwiber of standai-d C DPiiundv which *r H MB d i n 
conjunction with condl lianalu tnBy ,, , deB3fld thal their .^^ Bva , ua|e 
to TRUE or FALSE, 

a) IF and ELSE. IF takes m Input; if th* intoul evaluates to the uer4 
TRUE, th* rest of the LOGO tin. is evaluated; if th, input evaluate* to 
FALSE, the rest of the line is skipped, Hdu**bt, if £LS€ appear* in th* 
lim, this behavior is modified pn the obvious May. 



t\} check: :U 

10 IF UOfiDP t U PfltflT "UOftD ELSE PR[tfT 'NOUCRD 
END 

UDRD 

?CHEC? [TWrS LJ$T] 

HOUDfiTJ 

IFb [op JF-fl.g£ pairs] can i» stacked within thB»BEluet> 

TO BETTERCrECIf *U 

10 IF NPT EHPTVP E y T.HEN (IF UCROF :U THEN PRINT -(m 

else mirn -ndudrdj else paint -empty 

END, 
Mer C . Th£W I, 4 "noiBB Hprd" uhlch does not in ittilf affect the 
•Vlluttitn cf the LOGO W „ si on in iftlch it appears, but hefp a <* nahe 
tti synt^ <rf the ^presslon „ Q re "natural". Th 8 P ™(h™ are a-su 
optional, but help to p*b th* eKpretBion easier to read. 

&]TEST, IrTfll€ h and ]FFa L 5E, TEST ■*a| ll> i„ it, arguB(lft < (lo ^^ or 
FALSEf ard put* the r*«ltl in a "test b x< . Unti| ^ ^ ^ ^^ 

(■bfawiattd [FTr and 1FFAL5E l»>r«i a t« IFF) ui 1 1 |„ k p nt p t h 8 boa and 
cau« conditional E « cutiDn &f thH r „ t D , thfc 1in| |fl ^.^ th ^ ^^ 
We Ip no davice a n 3 | DgQus < D ELSf Mhlcft a]|ou9 eDndi , iona| MWt|tjI]I1 flf 
Crtktf a part D f th, r ES t of the l™. $ C * H ™n,obvi«i, br Q pBrti„ of th, 
t«»t t»K are; f ir .t. If no T£ S I ha, b e . n rn.de, the *e» stains FALSE by 
dtftrftl second, the be* j B urlqua- a neu TEST, although it K8v havB t„ n 
•KecutKl conditionally, change* the contents of the be* abaoliitily. 

Each br K e*jrg has Its Dun 't«t b**\ rf,i ch j s gtrictly local to 
that procedure TEST, Mhich 8 r B made in a a^rocedLira du not affect thB 
test bo* o.f the calling procedure, and converse ly T 

IF7RIE and [FFftLSE can appear ar^hnre in a procedure, and they dC 



not have to fie on the Eana line [ Indeed 4 coMind ouch a a IF TRUE "FDC 
TFFALSE "Bftff can rwver eau P » 0*R to be evaluated J 

3.3 TRUE wet FALSE a-e LOGO fjwda. It 'n perfectly val id to say 

TEST "IRUE 

TEST UOnD H Tfl ^UE 
Hffhentier that all word? Hiich are \o be tiksfi I i re-ally ituit b« 
qyoted on type in le*cept for nunbca] i 

TEST TRUE 
uill oKfrect urcu to hawe 3 procedure nahnd TRUE. Also 

TEST [TRUE! 
I* ann error. (The. input to TESTuujt he a word,! 



18, LCflrSPACE 

Ulhren yuu rfttfqrts i p^OMdurft or create a ne«B by using MftfE. It 
becones a pari of your uprk&paca. You can think oF your uorksp^ce 3e a 
chalkboard nr scratchpad containing all the procedures you are using, the 
LOGO file &ysten allays yau> to atore everything that Is In your workspace 
and retrieve it at 50IPB later 'iir? isee Chapter ill. Before a procedure or 
fiane tan be used It Must be in u*wr uorfcspae*H To get aonething into the 
wOrHpflCe you mult cither type it in at the console or read it in from a 
LOCO file- There arc alsa conriands far examining and getting rid Of 
various part* Of the uorksoace. 

ifl.l UHAT'S ]W A U0HK3P4CE? 

PRINTOUT (abbreviated PD] if a command trtirch prints out varicua 
pari* Of yOwr uork.5pacer To qqe the text of a procedura h type PRINTOUT 
foMouE-d by the procedure nana. (The procedure name Is mot quoted.} 

FRrNTTJUT TITLES (abbreviated PC TITLES or POTS] prints out the 

■ 

titles of all procedures in your MOfkspac*n 

PRINTOUT WES ( abbreviated PO NAfES) print a out all the nafrea in 
your workspace.. 

PRINTOUT PROCEDURES EP0 PRrjCBQUFiESI prints nut the ta*t of all 
de f i ned procedLP- a s. 

PRINTOUT ALL (PC ALL] print a both names and procedures. 
[The PRINTOUT LtNH and PRINTOUT TITLE eomnands are discussed unfler 
editing. PRINTOUT PILE and PRINTOUT IffiEK are diacuaaad under filing The 
PfUNTOUl ARRAY and PRINTOUT ARRAYS cnn-nand* arn d ! aclj-i -n=d under arrays.* 



!|"E •Z^>-3': iCI ECNTEHTE nu:f:"..lf: A list C.<:-i*.a iii-y thu til *"i nf ,1 1 | 
procedures in your workspace. Hq1c the distinction betus-cn CONTENTS and 
PRENTDUT TITLES. The forrer is an ?peration + uhi le the latter r a a 
CQfMiand. 

A similar disTindiofl (xiits batman the comand PRINTOUT" and the 
operation TEXT. TEXT takai ana input h a procedure name (not auotedl,. 3rd 
output* tha text of tne procedure as a MbI, The lines of the prateoura 
appear as nudists. Tha END statenenl is not Included, 

10.2 CETTltfc fl]D OF PARTS DF THE UOflKSPACE 

The bask comnand is ERASE law*- abated ERh ERASE folltwad bu a 
prooadur* narie fnel quotad) rautovas the procedure froU the ugrkapacct 
There are a I sot 

ERASE ALL Gets rid of all ranes and all 

procedures. 
ERASE PROCEQLPES Get a rid of the procaduraB-- leaves- th« 

nahrS. 
ERASE NATES Gels rid of the names — leaves the 

procedures. 
ERASE NAffE Tjkt* ona input, * nana (qyotcd) . and 

gets rid d* that particular na-ne. 
[ERASE LINE is discussed und*f editing, ERASE FILE and ERASE INDEX 
are discussed under ■filing, ERASE TPAIF- sid ERASE STEP sr^ discussed under 
debugging. ERASE ARRAY and ERASE ARRAYS are discussed untie* 1 arrays. 1 



10.3 BURY 

The B4JRV connand effec!iv*|y. 'hides' « procedure and protect it 
from ace Cental deletion. BI.FV t*es one hnput, the Pane at !hr. procedure 
to be, tidied I the conriand BbPlf" ALL tan also be used), Once a procedure ,-ias 
been buried, i t ui I | not appear in any PRINTOUT corona unlets it Is na«d 
explicitly Fgr B**nple.a Hit FOG »*iich has b«en bean buried ui I I hgt 
appear under the Cor-anda PETS and PQ ALL, but the co^nand PO *F00 ui 1 1 
print out the content) a f F0Q. This property also holds for Eq*3E 
comhands. ERASE ALL uiH mot erase buried procedures. &yf If the name of a 
bur fed procedure is apse 1 tied in an ERASE conrrand It ul M be erased. Tc 
unbury a procedure, the corrmand ERASE BURT (n1 I cued by the procedure name 
tor AlJj is Listd* 



i 



U. ThEFELE 5VSTET1 
The LOCO file nyatem allow* you to save Inn di»KP what d in y OU r 
wprk space and read it bart at a later ti M . A UH r nay h*va nany fil«| at 
enta. The Files are <jr,t inguighed by the *aet that thau are named. All 
filet belonging to a single user *-? groiped under that unr'j ind^ , 

U-I USE, READ, and URtTE 

The CMiaand USE apecrties (ha index under uhleh LOCO should 
ref*r«n« files. AM subsequent READ nr LRfTE cnmnaivi* mi II refer to that 
ind**, until the- next USE, USE takes one input, lh« ouoted name ef an 
irrde«, uhleh ie a utjrd af up to [tn'charaettrt* Far e^ipla. to reference 
the file* under the mde* ELHfijE. >ype 
USE *EL0IS£ 
The URI TE eOhSand rrtataa filet, It tafcea Ona Input, th+j naoe dP 
the fife to be created [a unrd «l up to ten characters!, Into the file 
goes everything that it currently in the uaer'e work space* 

This is a corwKtf aource of confusion, flany users Often thtnk that 
if they hgvg, for ekanple, a procerlurg na n BC ) beetle, then 

URITE 'BEETLE 
uill sorrehoM save only that or* procedure. T"hi a is not the =a&e. All the 
procedures in the workspace Mill be B sved. 7h. fila uH| *BreFg have lr,e 
aar*e name aa pne. of the procedures in it. 

If the Mitr already has a file with the saire nan* aa the one to be 
cr«»ted h LOOOwiir first ask If the old one ohaitld be erased and then- wait 
for a response 1Y or Nl to be typed in. The dd file feuet be erased before 



a nan f 1 1 s nitJl the sang nans ^:an bo treated. 

The READ conmand takes 3 f i la nane at input and reada The contonta 
of tha fila into the workac-aca.. AH pr«tdurtB and rvanej t&vwd in the file 
will then decoife defrne-d in the workspace, if the uofKapace already; 
contains a procedure Hlth the $an« nane as ane of tha procBdures in In* 
f i ie. the praeedm-B m li nor be t^mfef innd and th? definition/ in the f i ►* 
Mi I I be skipped. 

SttAf 3 ^ {*Bt Sactinn 13-31 cannot be saved In ^Mws, If PtC for 
cwarrnle. i& the narr* of a gnap r then m-iting out the workspace and read^gi 
it back will cause -PtC tn betoae the ai*pty u^rdn 

11.2 P0[ ar>d POF 

These art COWnSnda uhieh allou y 0U to BMaaine filae, without reading 
them into the uork apace. 

PRINTOUT rHDEX (abbreviated POIl takes no Inputs and print* th# 
nawee of all the fHai in the Indl*. {The indan it specif ied by the 
preview* USE coimand.J Pfl]NT0UT FILE IPO FILE) takes a f i It n»g a* input 
and types the extents of tha flla t ]t does not reed tha fila into the 
udrksua-cE, i.e.. prgcadurss in the 'Hi urll not necc*i dafrnad in the 
workspace. 

ERASE FlUE IBfl FILE) takes a fila nana a* input and gats rid of The 
i le, 

. 
11-. 3 FILE 5U3TLET]fS 

7hi description of the filmg ays Ism bo far> though accurate and 



adequate for ordina-y use, i B incomol etc. In fad, Ihe LOGD Hit ay-step 
hSH a tree structure. The commands USE, HEAD, UR1TE. etc. H as describEd w 
tar-, Make ubb of tjhat structure only Implicitly. But ttoy can be mad* to 
Use the filing lr*e rnKh mart illicitly, and" there «ra other cnundi not 
yc« discussed trfiier all™ a user to nanipulale the tr -? - pruning i1. 
adding branches, etc. 

Each user'* lnden can be- the root of a generar tree structure of 
*Hfl*. This, mean* that the i nde» may not only contain filea, hut also »uP- 
Indices which can tain files and sub-indices and so en. For anarmle, the 
inde* £LDI5E night contain the fries QAY1, mHBLE t and the *u&-in<to* 
DISPLAY uhleh contain* f J las dealing with Elorse's display prgjects, [n 
thie case < the tils structure Mould be: 

I ELDISE 

DflTl 
F1ARBLS 
I OtSPUW 

mx 

DRflJJ 
PDLY 
etc> 

The J - j specify indl«S> (Normally a number hHI appear after each 

MLe r^me, Thl s jt JLrftt the number f storage block* that In* fi| B 

occupi«.) This tree structure is prinlad out by the PC TREE command, 

(Nole that the tree is actual ly upside dgun, with the r 0D t at the top. For 

this reason, the root of a tree is often referred to as (h* "top I Ever of 

thE file tyttarii H _i#iMe the branches, are taF led th*."lp H er level a", yhere 

sach sub- index represents a neu iev«l H > P01 does ngt print out th B 

content a e-F frub indices. In th B above case, it would prtftt; 



EL0T5E 

DftVl 
MARBLE 
[ DISPLAV 



4 The root inde* daes net have ah [ prinKd beforB it + 1 

Each file in This trw Structure is specified by a list starting 
ullh the user mane. This list gJv*i the "path" doun ths tree fro» the user 
narre to tha file. Far exanple + to read the ill* DflAJJ in Eloist ' s Hub-ind«* 
DISPLAY i«e could aay; 

USE "ELOESE 

READ IDtSPLAV DRALJ] 

or mb could &ay„ 

USE [RDISE OlSPUr] 
READ "DRW 

In gangral , the input to the READ cownand 1 9 adtfed onto the Input 

of the previous USE zonriand and the uncle string become* Jht flls 

specification. (What happens It (hit ths USE camtiand Establishes tbe level 

from which all foHouing eoHnands are to bs carried out. Thus* if the USE 

coimand refers only to the ustr ngne, ths bath to a file containad undar 3 

•Ub-ind*K-w'i It bj longer than: If the USE camnand refers to the the oeaired 

aub- index. Ue ui 1 I see I aler hou th.it live. I can bt Changed without 

repeating the USE conned. I The inputs to LEITE, FGF, and ERASE FILE all 

Mprfr in tie Eaif-e May. Uh« le PHi prints out (h* ind^x ipeolFltd by thfl 

previous USE r.fr*iha-id, TO TREE prints out a nore completa version,, 

consisting af all sf the tree contained belou thi* lnjd»x. including S^fr- 

!ndlc#t a 

To croat g a at*- index, the CMN1JEK co»»Pndl is UStdh This 3d^S ?n 



to th* branch specified oy (he previguj USE. For example. ELO[5E"S suo- 

index DISPLAY u&s created by typingi 

USE "ELQ!££ 
CHtNDEX "DISPLAY 

7a then create a srt-inde* of DISPLAY naiFird PLOTTER, uh could 
sinptgi fray: 

CR INDEX [DISPLAY PLOTTER] 

To get rind of an inde* use the ERAS INDEX corp*and. Thia takes cnt 
input which specifies-, <r- the 33te nanner as the abn*e commands, the i n-dex 
to be erased An index nay fin I tje era?ud unless it is snptuj, U»+, 
contains no files or sub- i nd i eta ► 

Once am index has been creatsd h It i-e paa-a Itilct to adjust the root 
of the file tree so thai all filing CDnnanda refer only to those file? and 
indices contained in the tr« bo low a specified inde*. The command which 
does- this is 5£T|N0E>{. 5ET1NQEX (abbreviated 5ETM tafcefl one input 
specifying Sn i nde* which will b« thi root of a neu tree farming sons p**t 
of the whole file tree a* the workspace. As &efcre H the Input sped fie* 
the path taken dawn ar up the Ire? ffpn the current root ta reach the 
desired ince*. |f nor* than Dfie leva! of rndieet I) involved in the path, 
a list il necessary to specify th* iJhol* path. Housves",. if the desired 
injcK i ^ jy^t erne level above or belou the current root, a s,ing1e Herd is 
suit iciemt to apvcifu the oath. 

Dnce an index below the user nane has been eatabl iahed as the 
current roo.t b all commands refer only to that part nf the tree be low this 
Tien index. For tKariple,. let's consider Eloiee'a file system again, onlyi 
this time uitti a Feu norg orancheE added: 



ELOISE 
L DIEFLAV 
UALK 

PtiMj 
POLY 

I ALGEBRA 
FACTOR 

I Mimx 

INVERSE 



In order to make ALGEBRA the nen coot I ride*, ttia comnind SET! 'ALGEBflA is 

uses. The ran tree {printed out Oy PQ TREE! looks I ike thin: 

ALKQPA 
FACTOR 
I MATRJtf 
INVERSE 

Malic* al&o thai filas not in this part of the Ires cannot o* reiti 
ultho-ut going back up the "branch" and down another until the appropriate 
index under uhloh the file ia corttaintd is reached. For example, typing 
HEAD "POLY i-pI 1 1 return an error wessaga. TELE NOT FOUND", jinee the path 
na«e has not been fuHy specified. 

In order to rove the current root back up tha tree towards the nam 
directory name, the input "* r* usad< The up-arrou can be used in I lata 
Juat like indes names. SO that l.lrit containing n * h a uaad as Input to 
SET! moves the current root up n levels. Thus, in the above e*ampie, in 
order to rasd POLY, the conmand REAC [* PTXtJ la mad, 

11.4 OPEN PILE rlAntiPULATLDH 

iQPENU takes one input, a desired (lie name Iquoted] . [Thi* file 
does not have to already eniat in |ht flit agttaK. J ►DPENU opena the 
selected f'le [or creates one i f I t does net already exist) and alfoua it 



to be uritlen into, starting a1 the beginning of the fils. |f the file 
already e*ista in the filing sutte*, the u(B r hIM be asted to delete it 
&*fOr B writing, since the old Intonation contained In the file H H I be 
urittln ovar by the neu input to the connand ,FIL£P. 

■ FlLEP is used, once thi file has been ppened For wlting, to 
perform the actual uniting. r FJLEP- ^k B9 as ir*ut a list contnlnfng the 
desired infDTHtlM to ta« bitten into the flf, r Each- time .FlUEP i 9 ua«l, 
a neu Hn B <mth «, ma*™ length of 138 character*} n orated in |h Q 
fill. The input to .F1LP can also b? a procedure nar»* [unquoted, in 
which case tne procedure it executed and itj output is hi- it ten into the 
file, (t thera is no Output, nothing jj written. 

, n PENA open? a file for writing nuch like .WENU, nut all 
inforMtlon written i» added [appended] to the end of the tile. None g.f 
the original contents of |h* file era altered, .FILEP i*rka in the tffr,e 
manner a& before. 

.DPEM? is ysed to open a file for reading. ]t takes One input. Hie 
desired file na*r. fquatedf P Ihe conn«nd u ,ed uith ,0PENR to dp the actual 
reading It .FJLER, Unlike f FILEP. .FILER take* n* input* but returns an 
Output. This output i s the current | jne of lha fiit being ^^ Evwy 
ti*e a file is opened for reading, an internal pointer Is » B t to the first 
line of the file. Each tine .FILER is uetd, this pointer is incremented » 
that- the next line if I If be rend U i th the Mk t use of .Fliffl. Uhen the end 
Of the file is encountered, on* blank I I n* »i M be printed put bu ,FlLEft t 
and than the t i I a m 1 1 be autonat Itllly cl C |*d. !n onto to read (ha file 
again, ,QPEN& nust be used again. If the current I i ne D f the f r le is a 



procedure nan B . thai prDeeeM-e will be executed, HThis fact ena&lea a y SB r 
to execute procedures F ihb1 ic illy 1 " uhi U reading a fj | B . tti* Utilize^ 
Dy the I NIT file; set the LOGIN command,! Any word encountered uhich I* 
not part of a procedure definition gr i, not a LOGO CDnmand is assumed to 
be a procedure name, ]r auch a procedure deee not eaiat, an error will be 
returned* 

.CLCStT I* used to dose any open f Me. .CLOSEF takes no inputl 
3r>d closea the fil* currently open {only or* Tile at a tine can be open). 
If no file ia currently optiv the conmartd ie ignored, 

11.5 LOGIN 

LOGtfl tafcsi one input, your user name IquotedT, This "tells- the 
system uhn you ar*." , and tins irtfurnat ion u used tiy [he PEEK ccwinand. 
LOCTN also perform, an automatic USE. Hotter, LDGIfJ Is nott useful for 
initializing certain conditions in the ugrkgpa-e and for printing o-ut mail* 

Llhen LOGIN Is u&ed t the suite* looks in the user's File system to 
«* if there is a file n*ned |K] T in the top level of the flit tree. If 
this file tKUts, lh* eyeten reads the file and perforiia g1 I commands, 
witten directly into the file r through th« use of the eOAitiA-ida . 0PBWI t 
■ CPEWA, and ,FILEPl. Thra facility alloua the user to do many useful 
tl-ir:^, z or innMr-Tc, W I N I T fi.g :3n b* :j 3 cd to -ea*_< all (ha 'i es i<i 
the user's file syate* ^autohatieally" rtsn logging In, or to print 0*1 1 
nessagsa upon logging in 4 

The LOClN coniand also causes the syatem to search for the file 
named HAIL. If this rile ia found, the contents are printed, and the user 



ia then asked if the mail shauld be deleletf. 

ll.G PAPER TAPE 

LDOg precedure-g way also be stored on piper tape. The user may 
pas* information between paper tape and th* Harkepeze using the fol I cuing 
pr in i t i ves. 

URTTEPfP punches out the conl*rit» of the workspace onto paper- tape. 
It does not invoke the file *y»te*. 

REAQPTfl reads Into tNf Hark&pace fr<jn the paper tape reader, 
Neither READPTFI nor UfUTEPrR take any inputs* 

You should have auneone show you the nechanlet vf using (he reader 
and punch nef^e yoir use the paper tape canmanda. 



12. TURTLES 
Tuis seelign \b abou( th* phyaicaP titles that run around on the 
floor. 15« Chapter 13 for display turtles.* 

12,1 Vou fiusr tell the ^t*r. uhieh turtle you uanl to use bePors issuing 
turt le comsandB.. 

TURILE 

Tihtt one inpul uhich should ^» the lunfctr of the turtle you want 
to UK> The numbers .v n marked above the plugs on the controller bo*, and 
*r# 1. 2* 3 or 4. Norma My only 1 and 2 havt turt lee plugged rntn the", 

NO TURTLE 

Takes no inputs, NQTUFITLE releases the turtle fro* your cpotrpl so 
snneone else can uep It. 

i 

12*2 BASIC TURTLE QfjnnANDS 
FORUflRD [FDh 
SACK 1BK1 

These eormdnde ta*e tire input which tiuat fjs a ngsfrer between -327GB 
ancT327G7 inclusive. They- ccmband the turtle to move <lnout> unite forward 
(in the direction it ia pointing! or backward. 

RICHI IflT) 

'LEFT {LTI 

Thet* take one input nhicn suit be anunber betupgn -3.27C& and 
32757 inclusive. Th cy cDnNand The turtle to rotate <input> degrees 
clocknia* r cauriterclo^uise. respect i velij. 



PEWJP fPW 
FEHnnJN WQ) 

Raises or loners the pen helcfing Hochan'ian of the turMe. Uhen !h« 
pen ra down the turtle ui I I drau a line as It naves. 

12.3 SOHE TURTLE? HUWG A HEADLIGHT 

LflMPDW 

LAMDQTF 

■ 

Turns the heatfl rght on and off. 

12.4 SOrE HAVE A HUSTLE 

TOOT 

Takts 6fii rnput which mus* be a numbsr between -327GS and 327G7 
inclusive. Jt gicu« th« tfiiatlt that nuntw of tints* 

12.5 TOUCH TUflTLES 

There ie a variety of turtle lhat have sensors tnat can tell wflien 
the turtle ie bunpina against an object. The fol lowing pripitivea are used 
to teat whether senior* are on or off. 

FTOLEH 

Outputs TRUE It the front of the turtle »s touching senethlng: 
FALSE otheriji ae t 

BTOJCH roeara Da:k touch 

RTOUCH meana right touch 

LTOUCH meana left touch 



Here' a a prijesdure t& bounce the turUe between ttiD ujlli: 
TO BOUNCE 

l& test ~iuj::h 

20 If TRUE LEFT 1B« (TURN AflDtNTJ 
30 FDRWRD jQ 
46 BOUNCE 
END 

If (he tui-llB is hitting an phjact at an oblique angl, tHO touch 
«i>sorfl nay be TRL€ at The san* line. 



1^6 SEEING EVE TURTLE 

U» ha*e 9 prototype lurt le-ul th-an-eye. Tc* eye is extrenely 
simple - it 1frl l 5 the Mpurtt or light it ia ?«|.n B In a *nry narrou field. 

LIGHT 

■ Outputs the light Isval. This ia a nuHtwr between 9 and E3. 

UnFnw 

LflfTPCFF 

■ • 

Seeing eye turtles don* t have hndMtfit* lyeM. These Cc^ands 
currently unable and disable a node whereby the eye c»n rntate. L*n°DM 
enables this mods, LADflgFF disables Iti ■ 

FORUARO, BACK, RIGHT. LEFT 

When in the node described abD^a these C0*Hands change the angle. D f 
election of the eye, Uhwi not in that note t h*te cumartdi per*or« their 
noraal functions. 

12.7 THE LIGHT BO* 

It ig convenient Is use the light to* f n conjunction «1th tha 
seeing-eye turtle. Th* light ton can supply current tC- any subset Of up to 



5i« light bulbs Hat !h B nonent only four light bulbs are plugged ill. Ths 
light bw ib controlled by ending it a number via the .lYG comnand (see 
Chapter 191. The I ighi pd* is specified by the input "LIGHT + 90 to send 
the- number 20 to (he bD* type 

«T¥0 'LIGHT 20 

What the bo* does when it g«t* a nunber ij determined as foil 0**1 

Urite the rajah**- in binary. Ther> the 

Tb place specifies uhether light nunber 1 ig to Pa on 

or off, the T% P l oca light Phiiibor 2, the ft's pi ace 
I ight number 3 h etc. 

Notat the controller to uhieh the light bote 
is attached traps 1? Ic-ctal 2U as ite reset 
character. Thus 1? sent to the light bow 
mil not h* seen, ]f you desperately u.ant 
to send 17 H 1 turn on light* f i we- and one 
tcgettierl y DU can us* (ha fact that the light 
bo* ignores hnrt than six bits and send it 
£4+17-81 iKtal 131 K 



12. B THE SUtTCH- PANEL 

The switch panel Is 1 "blue bon" uhlch hae an its fronl 1G smal I 
light Pulhs. Each of these lights represent! the status- of Ofli of 1G 
hardware §H itches. Uhen a switch is set. the cor respond ing light is turr»S 
wit when U r B cleared. Ih» light is lurn*d off. The f pi I o« i r*g - LOCO 
primitives can Pe used to teat and manipulate the statgj vt these switch**, 

SWITCH 

Takes one argunent, the nunber pf a SM^tch £8-151 and outputs TRL£ 
1f the sui ten is' eat, □ therms* FALSE. 
RELAY 

Takes tuo inputs, the number pf a Snitch and a valu* to be aas-igned 



to it T0 or 1). If B< the suittfh ia turned off, If i. it is lur-ned cm. 

Tjk.lt on* input, a nunbPT uhieh fa converted into a l£-drr;i1 binary 
value. Each digit of thia value ia then used to detcr^in^ ihp c-gncJ i ( i cm of 
the corresponding switch ief feclivel^p (he nane 3s Hmr f urn i ng. a RELAY for 
each s-ui tch) . 



13, DISPLAY TURTLES 
The display screen i I 400 turtle unit* high by 409 wide. The 
C^ter of the te^er. has cgordmalii O,0t : the batten left Hand corner it 
(-200, -2801 j and the top right hand earner if 1200,2801, Uhen the turtle- 
is pointing gtraight up it* fading r, 0. Heading, is neasured clockm,* 
[U«, RTCHTt Iroii .that petition. 

13.1 INtTJflLTZlUC THE □ E5PUWS 

CLEfiRECREEM tCS] 

Erases everything on the display screen and place* the turtle at 
th* cefitw of the scree* pointing up, y D u should do CS Hftt, before 
ig&uing any other coruiands tp th» turtle. 

UIPEOLlW £UC» 

Erases everything on the display screen but leaves the turtle uherc 
it i), 

nooispuv 

Turns oft the display, 

STAflTgiSPLM 

Tafc« one input, uhich nusl be or 1 , starts w a half-aizt 
display, 1 E ta^ts a fuM size Cf I splay. STWtTCISaAY 1 is the sane a* 
CLEAR5CREEU. 

13*2 BASIC OT.1ANDS 
FORUARQ (FD> 
BACK [080 



Take* Oft* input which must be either an integer or floating point 
ni*itrer. Moves the turH* *i n put:> unitj forHflrd (in the diretllort it i? 
poi-ntingf or Iwckuard. 

FIGHT [RI| 

LEFT ILT) 

Takes on* input which ■us.t b* either an integer or Moating point 
number. Rotates the Hurt I e «input> nunber of degrees dockuiae or 
counterclockwise, rcipgct ively. 

PENDOUH IPO> 

PENUP CPUf 

Lowers or raigeg the turtle' a Sataphnr ieal p*n f If tha pen ii (J-pun 
Ihe Hurtle riraue a line a? it roves. 

FEW . 

Outputs TRUE ft tha pan fa do«n. FALSE if It is up. 

WAP 

NOUfW 

UFftP enables a node bo that I t you try to nave the turtle beyond 
the edge of the display it wraps around to the other edge. HOURAP turn* 
Off this ffDde; if grou try to move beyond the edge u,ou get an error, 

HtDETUFITLE <HI» 

SHCSJTlflTL£ [SI? 

HCDETURTLE tills the computer to atop shBuing (h B little triangie 
that represents the display turtle, The turtle uj i I I it HI draw lines II F 
the pen is down] even though you cannot sea him. SHOUTUHTLE brings the 
tor I le out of hiding* 



13 + 3 SNAPS 
SNAP 

Tafcfti no inputs. Outputs a reHrmcs to "the sluFf on the display 
3Cr«n, * For eKanptet 

HAKE 'PIC SNAP 
causes tPIC to refer <& whatever is current fy on the Krnrv. Later you 
can cause another ccsy to appea- by saying: 

OISPLAV (PIC 
or Erase i r by: saying: 

UIPE [PIC 
Each SNAP has associated with it 4 "starting location" which It 
normally (he center of the- screen [but see also NEUSN*P) , SNAPS cannot be 

+ 

saved uhth the LR]TE coMMand (see Section 11. U. 

0] SPLAY 

Takes en* input which nuat be a SNAP £i,o. a reference Crated by 
SNAPh The 5NAP i« displayed at the currenf turtle, position and lbs turtle 
is then n&^ed to the end af \ht 5toAP H as if the turtle had juit drawn trie 
SNAP eKpl >c 1 1 ly h Th B turtle's- heading has no effect on the displayed SNAP. 
Tne SNAP aluayg appears in the orientat Ion in uruch It ust originally 
draun. 

U]PE 

Takes one input *ich nust be # SNAP, tt erases at I appearances of 
that SWA 'roB the display screen. 

NEUSNAP 

taxes no Input t. Jt causes the image currently on the (Crwn not 



tO be pari fll aubse^eftt; SNAPS* Al** seH !hc starting location nf 

tuhseoMoril SWAPS 10 (h* Current boaition o» the turtle rather than the 

■ . ■ 

center of the !ff(W, 

13. 4 LOCATING IhE TURTLE 

HEfiE 

5ETTURTLE rSEH) 

WERE outputs a Mat of The rf-coor d i na I; e . y-C OOrd i r»a I e and heading 
of the turtle. Ygu can ute HERE to ni» l place- on the dieplay. SETTURTLE 
takes che input, a list pf three rcunbirg bttultn -32758 and 3-Z7&7 
i nc i U* I *6. The fii-$t n assigned tD the x-conrtf ifiate H the second to the y- 
COC-rdinate and the third 1o tne heading. Vou can use SET/TURTLE to move the 
turtle la a place that use naned y*ing HERE* It hi 1 1 draw a line if the 
pen 1 g down. 

HDrtE 

KDDfl 

YCOR 

HOrE la equivalent to $ET| [0 & 0] ♦ XCOB outputs a mjUber uhich la 
the current x- coord mate of the turtle. YCQfl output! a number uhich ie the 
current y-coordinate of (he tuMlft, 

5ETX 

5ETY 

3ETX¥ 

SETK takes one nunericjl input and mo^es the turtle hor izontal luj to . 
that X-conrdinate.. 5ETY \&.v* one nuherical input and moves the turtle 



vertically I* l>»9l V-caordinate. SETXV ta*es two nunefieel inputs, and 
noues Ihc turflfl "o the designated position. Each ct these C&*iH3nd» kill 
dran a line if the oen is donn. 

HEADING 

SE HEADING 

HEADING- output j a nutfber uhich i& (he heading tin degrees! nf the 
turtle,, i.e., the direction in uhlch it 10 pointing. SETHEAOiNC takes one 
nuntier as input and points the lyrtl* in that direct-ion. 

13.5 PLOTTER 

The plotter is otten used in conjunction u'r\h display*,. To ues the 
plotter, tujpe PLOTTER. I4hen you are through using the plotlfcf. type 
NDPLOTTEhV All other plotter coiinanda are the jahp as display. eo*i»and s h 
Hone-***-, c»rt*lr> display EDnna^ds da not apply to the plotter and ui I I be 
ignored if typed ta the platter. These- are all fairly obvious: they 
include: CLEAflSCREEH, H]FECLEAN, klHAP. H [ DE TURTLE , 9)G4JTLJRTLE> SWAP* UIPE. 
and DISPLAY The fclottur also has a iore restricted argonent range than 
the displays. 

13. G MULTIPLE DEVICE CONTROL 

It IS possible 10 Control tigre than one dswice at at time on LOGO, 
This c3n be dena thrcugh tie use :?' the ;or7 = r id5 A-F.0 and CNTSl. If you 
are already using on? device and uish to use another without giving up the 
flreti type 

ALSO <oevice> 



where *.device> n tin device you Hlsh to use. ALSO gives you access to 
additional devices, but it is. necessary to specify -to umch device a 
specific cowiand is directed. This ia done with the CfJTRL conmand, CNTHL 
takes one input, the nane of a device which you currently "cun" , and 
specific* that devfct 9$ the Obj«l of tht ntrft qpnnand you type. For 
exanple, suppose you are using a display and you decide you uant to use B 
flew tuMle 9>sOh Fir»t lu.pi 

ALSO TURTLE tnuhberj 
Houever, If you now type 

TOOT 
LOCO ulll respond 

TODT ONLV VAUD ]F VDU HAVE A TURTLE 
Before you can direct connands to the turtle, it is necessary to 
type 

CMTRL TURTLE <ngriber>. 
All valid Moor turtle conirands will nou bo 3c cop ted r [f you uafil I© use 
the display again, you pust aay 
CNTPL DISPLAY 
LOCO nou uill accept display cotinands, but hot floor turtle 
conmsndB, Each tin* you uani. to charts between divlees. the OnTGL command 
referring to the depict thai ¥ ou u*nt lb USB Bust b* typed. However, 
subsequent commands can only rnfsr to one dnvice at a tine* 



Ik. hUStC BOX 
LOGO has prinl fives which, supply output ipr lhe music ton*. A LDtti 
user can specify par It for w tn 4 sinul taneous *oices H each «oie* having a 
range of five chrntrjfic octaves^ ]n order to avoid lining profile** the 
music i - i.::.nf:i :sd into tenpof-ar-y storage and then output to (he be* at 3 
constant rate. i-g?he- than played in "real tine". 

14.1 NOTE 

The NOTE cewnand generates ore not* M music, NOTE tafces two 
numeric inputs the first Specif iea the pitch and th second the duration. 
Pitches are numbered chroma t ical fy fro* -24 to 36 with 8 being middle C 
ThWS art alio three special 'bitcheE": 

-28 is a si lence 

-27, -25 are the percussion sounds '"boaa" pnd "§*h^ 

-25 is not a wa 1 Id pitch 

Dura I Ions nust b* belnean and 127 unH 5l Each unit ia nornally 
about 1/3 second Chut »« NYDICES belou]. 

Trie actual output of MOTE iP t0 it determined as follows* 

[f iD - NOTE goneratea nothing, 

[f tD - 1 NOTE generates a pitch 1 unit long 

ff rD > 1 NOTE generam a pitch ;u-l unite long fallgued by 1 unit 
nf rest- Th-troforc, mjaic mil not aouffld 'slurred". 

If :P 1b -2B or -27 NOTE genera tss a sound lor One unit followed by 
tU-l units- of rest. This matei it convenient to use the ptrcue-sron eounda 
tc "generate a oea'fr 



NOTE can also take multiple inputs + Tfit fci-hal It (NOTE (PI sOl 
: P2 :D2 ate,) f#iBre each pair apecifrea the pitch and duralmn lor one 
note, (The total nunber af input a nuat be even, t 

L4.Z Pfl 

Th* con»atyJ PM fstande for PLAY rtrSCCI takes no Input*, tt causes 
the output nf prevloua ND'E connarss to be played on the *itr*ic bO* t Aa the 
INJtlc >t played il it erased fron tenporary storage and iruat be reoeneraled 
if you uiah to hear it again. Typing a ctl-G uni le nusic is being played 
causes an i^fcediate break and aiaa clears out temporary floray^ ACLEAfl 
can Oe used to clear nut the music butter. fTenpora.ru; storage is a! located 
In the eane area aa the user's procedural, variables, etc. The ancunt of 
tr-.i 1 r- « :.. t\a: h.T.. hr rj^tipil^d at one time depends therefore on hou much cthtr 
stuff is in the user uar* space- 1 

J4.3 VOICE 

The lueic systei can generate up to toUf a i MJ I tannou* voices. The 

VOICE coftiM*nd directs the output of subsequent NOTE sormanda to- the various 

voices. PH then plays the voices alirjl taneaualy. 

Example; 

TO SEVENTH :luWC ill 

18 vp|CE 1 NOTE i TONIC ;D 

20 VOICE 2 HOTE iTDNJC+l t Q 

38 VOICE 3 NOTE ;T0N]C+6 :D 

46 VOICE NOTE iTCMC-tS sD 

58 PH 

EMD 

will p I ayi a chord. 



VOICE tafces one input which iujl be a nunber beluepfi 1 and 4. Thi* 
be£0»SS the current voic* until (he next votcn enrtmantf i« given, ]( no 
VOICE eamrand is given* the Syateh output? to voice number 1, 

14,4 VLEN and CLEW 

These Sre operation* uhieh take no Inputs, VLEN output) |h» total 
length of tna huEic coripi ted for tne current voice. HEll output* the 
length tor the large&t voice- 

For instance! if h( have genera led a malady In voice number 1 ue 
tan provide it uith an acconpani rent; 

TO QOrPAU 

10 VOJCE J 

28 1 N0T£ 9 4 (-51 4> 

30 LF VJ.EH - HEN STOP ELSE CO 28 

END 

This uill generate oorrf^h B for aa long a? the nelody lajts* 

14.& HV0ICES 

The rwjaie eyslei* non&ally multiples output anang four voices. 

Voices #or Mhich nn output he* beer> generated are fed silence*. [t in also 

possible to uend output to only one or tuo voices, Thia is dene with the 

N VOICES comnandt 

N.VDICES 1 output only to veice 1 

NvDjCE^ 2 output to voices i and 2 

INDICES 4 output to all Four volcti (the nornal node} 

Since the au*lt ho* in fed at e com tint rate N VOICES 1 Iresp. 

NVQICES 2] cauae-3 the basic unit of duration to be one- fourth (r*sp + half} 



as Itmg as uith VOICES 4> HffllCES ilio clean Qu t ternary "tera 9 * and 
resets the curr^nl voice |q voice ],. 

i4,6 music 

Only cmo uaer at a tin* hag have KCni to tin* tiuaic bo*. When a 
user give* S huaic co^iand. LOCD assign* the nutlc box to nil* if nn ^ 
else if uaing it. A yaw say ralgase th* *uaic eyitam by giving the 
NOnUElv c^nir.snd, 

14.7 HUTVD AND miSTRl 

These conn9ndB are a Cnnt I «u 1 1 on toward nil -Una m^ftic general Ion. 

i 

They arable the uaer to fcybaHB (he hiuusic buffar, arrd rha Pfl crnimand, and 
hmcfl hflye 8 Chance at least to generate r«gl-tiae mu*ic. 

njTVU takes 2 inputs, eath one a Mu>»ic boy pHrfi, and nAtl tho 
mug it DO* blau the & itches. Pi tchea to fUTVO are the aa»e nyhbera a? 
pitches in the regular huh i d aystch — riddle C ha 0, r BB t is -ZB. and aa 
forth. rUTTO autamal icaPlu eonverta th*u bitch nu^, r , into th, numbers 
the nuaic Uo« harduara require*. 

m£TRL stands for music control. It» nain purpose la fo ibecrfy to 
the music box ha+ri«ara hD u nany voice* you uish to ]oad. This is similar 
to the NVQtCES cowhand in the regular suiic ays tan. 

14,8 SY5TEI1 ctusiRArrrrs 

The Susie system hag been designed uifh specific mwa in mind. 
(See, „, B , the papers at Jtanne Bahbarger.l IjWa una ere hampered by this 



Should toe** |n mind thafr the i-TYIQ cownand csn b* ubbeI En nut put arbitrary 
character 5 to the music htm. I&ee Chapter 19, fr 



15. LISTS 

LOGO is -equipped ta ngnrlle general list?, i+G, lists whose elenenti 

nay then selves ba Hits- For txanpket 

[[THIS tSJ A [LIST STRUCTURE]] 

lz a lilt 0* th*"ae elements, tuo of uhreh -are lists. 

PRINT does npt print the out*r bracket! around a litl. 

?PRENT ttlHIS 1^1 A BLEST STHUCIUfiEll 
[THIS ESJ A [LIST STRUCTURE! 

All of the I r*t operation* described in Section 4 work, mth jtflril 

I ista t e.g.: 

MAKE "A [[THIS 15) ft [LIST STRUCTURE]] 

COUNT :* wtpu-t 3 

FIRST j A outputs [THIS IS] 

BUTF1R5T :A outvie [A tLIST STRUCTURE!] 

LAST it, outputs [LIST STAUCRfRE] 

BUfLAST : A outputs (ITHtS IS] A] 

SENTENCE general izes as tollpust 

If all of its input! are Ijtts, it puts their elements together to 

wake dm* bng I tstl 

(SENTENCE [PIECES OF] [ABIC] EL3STJI 
output* [PIECES OF A BIG L!ST] 

If guy o' the argunents to SENTENCE ars words it first converts 

each unrd to i one-uord litl artd applies tfia abo*s rultt 

(SENTENCE -PIECES [DF] 'A n 8(t tUSTll 
outputs tfEECES DF A Bit LtSTl 

LOGO tiaa seme other list operation!. LEST takes two ifipulfc and 

outputs a 2-tk event ll&l; 

LIST [THIS [SI [A LIST] 
outputs UTHIS LS) EA LEST]] 

LEST can also take multiple inputs. It outputs 3 Mat whose 



element are the inputtl' 

(VIST [LOTS! "Of (L1SISJ1 
outputi I [LOTS] OF fl.[STS]] 

Nutlet that if an inputs to LIST are uerflt, than LIST is equivalent to 

SENTENCE, 

r"l.r is another- I h1 cip*i^a1 i OHh It t*B9 tuo inputs of which the 

second must be a llftl. It sticks the first input onto the front uf the 

second to wake a neu II sit 

FPU!" 'THIS [IS HCL FPUT UORKSJ 
outputs tTHJS [5 K*J FPLIT U0PKS1 

FPUT [THIS ]S] [HGU FPUf U0P.KS] 
outputs I [THIS I5J HfJU FPUT PQft(5] 

LPUI »s similar. It stlcK* its- firit input onto the end o* the 
lilt, 

LPUT 'THIS US HCU LPUT UDflKS] 
outputs [[5 H-3U LFJT UCftfS THIS! 

LPUT [THIS IS] [HOW LPUT UQP.ICSJ 
outputs [HDU LPUT MRS (TtfIS 1S1I 

FPUT and LPUT can also ta*e nultrpH inputir The li-at input nus-t 

always be a tislt 

rFPUT "HAKE [TKISI [A USUI 
outputs infiX* [THIS] A LIST] 

[LPUT "1AKF. [THIS] [ft 'LIST) I 
outputs [A LIST HAKE ITW511 

- 

Lists may aiso contain SNAPS as elements, e.g.t 

flJUOE "A SENTENCE "UQU SWAP 

tnen it is perfectly valid to say: 

PRINT FIRST tA 
or 

DISPLAY LAST :A 
but 



PRJNT cA 
ui 1 1 givt jn error. 



IS, DEBUGGING FEATURES 
LOGO ineludtfr features which aid users in debugging their pro- 
grams. The simplest such feature is ctl-G. Pressing c^ 5 -G will stop 
execution of any pr&grflM, If it is not much help as a debugging feature^ 
it at least cin serve as a panic button. 

1G.1 PAUSE h CONTINUE ANO ctl-Z 

Uhefi tht PAU3E cotiit&nd !H executed in a procedure, the procedure, is 
lenporarily hatted and control is returned to thi console, In-atead of 
typing only: 7 as a prompt character, LOGO alflo indicate* St utiat level ft 
currently is, Level refers to "hou many procedures deep" current ensoul ion 
is. (Connan'35 given fron the eon-aale, are at level 0. Conmand'3 given In 
procedures called from the console are at levet I. Coniftands given In 
procedures called by level 1 procedure? are at level 2* And »o on,] LJhile 
in a PAUSE the user tan access any nanat whitti are local to ttie procedure, 
for exanple: 

T& &LA :A 

It? FDRUA3D :A 
2% PAUSE 
Efd 

A is a local nane. Running. DLA Mill cause LOCO to pause. Us can 

then access I he value of A, 

TELA 20 

PftU£E AT LEVEL 1 IN LIVE 26 [N QL* 

L17PRTNT ift 

20 

LI? 

There a*-e tuo uay-3 to get out nf a pause. Typing: ctl-G ui II, as 

usual, return the user to the top level. 



IHb CCWrtHJE co^and lahorevialotf CO) mill eontinu* *««c«l ing the- 
procedurs starting with the Pit!*! lift* after the PAUSE* [Note that for this 
reason PAlfiE should Ps the las-t eoiwtand on a line if the mer fishes to 
cent inue..] 

Uhile it is. legal to OjIy* any LDOQ cpniand In a PAUSEd situation* 
the user ffi 3y get irilo- troufcl* if he or she erases or sdit-s the procedure 
and then tries tD continue. 

Ctl-Z is similar to- ctl-G encapt thai It generates a pause rather 
than 3 brea'< ait the tap I em I. 

16+Z DEBUG 

Th* DEBUG corrT,and zhang** uhat LOCO does uhtn an error n 
encountered in a u»sr'& pro-gran. Norm My,, an error prints a rncssage and 
tarainatea executing The DEBUG f ami 1 4 ty Muse* errors to generate PAU5E* + 
The user can t+ien alanine local variables and CONTINUE with tn* newt line 
of the procedure. GESuTl is a conned nhicn takes no inputs, [ts use 
E=ujtrJ-iea this feature orr and off, 

16,3 TRACE . 

the TRACE comnand take 3 one input* tfiich is the narie <jf a 
proceoTyr** The procedure name it not quoted. Every ti*ie a THACEd 
pM-eceoHire is run, LOGf} print* out a message to that affect and tells what 
the Inputs (0 the procedure are* LOGfJ also indicates if the procedure 
outputs:. 

To get rid oF a TRACE. un ERASE TRACE as. im 



?ERA5£ TRACE ^procedure nane> 

It is. poseioie to It ace all procedures by raying TRACE ALL* There 
■3 a 150 ERASE TRACE ALL. 

1B.4 STEP 

STEP i» likea "auiwr TRACE" h Hot only it lh» procedure- TFIACEd bul 
bEfnrE Each Hne of thE procEdurs is a*ecuted < LOCO types o*Jl the line and 
uaits- far the user to respond. TlhEre are three options: 

III Typing a carriage return causes the line to be en ecu ted 

and goes on to Ihe neKl I me. 
121 Typing ctt-G tsrninatES enecution as aluays. 
iJ) Typmg c t UZ generates a PAUSE as described 

above, The user nay Ihen execute other corrmands and la^er 

CONTINLE. 

The syntax for STEP It likl TRACE. ERASE STEP, STEP ALL. and ERA5E 
STEP ALL -3-e also available. 



17. ERflPH rWOUfG 
The error handling facilities alln H you to nodify the u*y LDCD 
treats Err or 3 i 

17.1 ERSE! and £ROLR 

The ERSET comnand taken one inpgt, 3 procedure nane. As ui th TQ h ■ 
EDET. TRACE, etc. , (ha procedure nane If not qua led, EflSEt causes the 
procedure grven as input to be executed every tine an error occur?. The 
procedure mil a 1 90 be run every tine OM-G or ctl-Z ia hit, After the 
procedure ha 5 been executed, LOCO takes th. fal laulng action* 

I'll Jf the procedure doag not output, LDOO print* the nortial error 
Hessage. 

(2) if the procedure output 1. LOCO print* th* output th-stead of the 
noma I error meg sage. 

If an error occurs in the tflSET procedure it-n-1' th- ER5ET nil I not 
happen. The various SYSTErt BUG errore cannot be overridden by an ERSET, 
The ERCLR corsmand, tahicti takes no irujuta, deactivates EA5ET, 

17,2 ERRET and ERIN 

As described above r *n EFlSET c»n provide pereorvaf error -essagea, 
hut still terminates execution. Another use 0> ERSET is to »l lou the 
possibility of tiodi ruing the E cmri I | Ion that caused the error and continuing 
•*ecutien. The comnand ERRET Iflkes one Input, a lint nunber. and raturna 
execution to that line Of the procedure In Which the error occurred. 
Useful in conjunction u |th this i= ih- E*UH operation uhich outputs the 
line nuuber in which the error occurred. Thus, for a»anple: 



in an ERSET procedure mi 1 1 r^axecute tnt line in Uhldl ttw error occurred. 

Here is a uag to move a ball bach and Forth aeoss thw ecreen. 

5u£obb :BALL 1 9 a SH*P of « ball and ue r*j*o thB ball by: 

TD hOvEBALL 
10 FgRUARTJ 2S 
20 DISPLAY t&ALL 
30 U1A[T S 
fifl UJPt ;8ALL 
• S9 GO 19 
EM) 

Ruti ttOVEBAU but first EKSET the following procedure: 

tO TURN 
10 LEFT 180 
26 EflRET 16 

Now Every t i ma tha "CUT OF BOUNDS" error occur* TURN u,i 1 | turn the 
turtle around arcd keep going, 

Gut thil piiqpiE aches* hag a bad byg r TURN ul 1 1 be run Hhenevei- 
anu; Error occur*. Even worse, it ul 1 1 be run P*on us hit ctl-G. There i a 
no uay to Stop riD/VEBALLP Uhat m wily uant ia to only execute Hit ERRET 
In thtcase of the particular error "OUT OF BOUNDS". 

17.5 ERMMl, ERBRK h and EFIPRO 

To help over cow the above -rflen tinned bAig h UQCO provides fhe ERNAtl 
operation, Tha easiest uay ft find out th* name of an error, is to 
generate Ihe trror and then PR]NT tHNAn. U« can fix the bug in TURN atc-vui 



TO TLHN 

10 TEST ERMftn - -DOB 

23 TFFALSE STCP 

30 LEFT SflB 

49 EFIREI 18 

END 

('OUT OF BOUNDS" has error nan* QOBI 

EflPRfJ outputs the name ot the procedure in which the last error 

OCCUrrtd, to if M would (ike HBtf to on-ly Ufca effect during npVEBALL we 

cen T£3T tc aee it EHFRD - "HQVEeALL. 

EflBEK handles ell-C and cM-£. It ia an operation Hiieh wtpuHt 

l f 1hc "error" uas caused by pressing ctl-G 

- -1 «f th* "error" was ca«s-ed bu pressing ctl-Z 

6 Intern 1st. 

Sometimes it is useful to get things up to that pressing ctl-G 

durihg a REQUEST re-does the HEGUEST rather than stopping the erogran. 

■ 

Here is an e-xanp I e of h?u that can ba Oenet 

TO SFECIALREQUEST 
10 ERSET TflfJMiN 
Z8 n*KE "X REQUEST 
30 ERafl 
40 OUTPUT :X 
END 

TO TFIVAMIM 

10 1= ERBHK - 1 ERRET ERLIN 

E'C 

Ml th TRYAGnlN we can alrl 1 1 stop the ahou by hitting: ctP-Z, 

1T,1< EflNUtl, EflTOK. EPLGC. and TUNE 

EFWt Each tu.pt ot error has a nonpar ttwll ai a nam. EPMJ1 
output* the nuntiar of the error H 



ER1DK outputs the "token *uinber - at uhieh the previous error 
occurred in (h« line- Thii giv«» gone indication of exactly uhere in the 
line the error occurred* but It ii hard to Ufle unless you ire initiated 
into I he arteries of lh« LOCO #*alu3tor. 

EHLOC outputs: th* location ir the PDPlTfl core at uhleh the err-er 
occurred. It ia useful mainly to gyslarr proyanneps* 

IUNE ourputa the last line typed in at the conMlti ]l is useful 
for doing ana F ye i a of errors that occurred uhi Fe the user* uas typing in 
"direct ccunanoE 1 . 



JS. EVALUATING TEKT 

is.i RUN 

It la often useful to valvals cownanda that ha*e Pe*n coupvlrtf 

rather Thar* typed in< Th* b«lc LOGO prinitivi which does thie ia HUH^ 

RLTJ tafces one input, a list, and evaluate* It just as if the list wre 

typed ir» st the cfjnjpile: 

7RUN [f^LNT "UDUl 
LlQU 

|l the input to FlLTJ soBcifies an operation, then RUN outputs* 

TPflINT HLN [5LTI IB 5J ■ 

Of course, Ihe Input to RUM need not 6e typed in literal Iy1 

7PRLNT RUN CSE 'Sin IB 51 
Z3 

Far extfnplc: 

?T1AKE "K "FflEMT 
?RUTJ SE :H 5 

s 

■ 

Another example: 

U we hsye procedures called, tay, STRATEGY! . STRATEGY^, and 
5TflA"Erif3, cne jay lo invoke the proper one \w to tay] 

RliJ (SE PGRO 'STRATEGY iN) 
if fN It 1. 2. or 3. He uee SE uith one argunent tince HUN r » input must be 
a I i i t h 

Ther« is a tricty point here. RUM executes the I fit just ae I f the 
I i e t nere typed '.n . ]n the example 

RLJJ CPU I NT -U0U1 
the first character in tne second uwd of the input .i( a quote. To 



ptncrate the list ue uould say 

RUN SE "PRINT ""UGL| 
in CGntr&Ht the comtiand 

^LN GE "PRINT *m\* 
it eqiiivgitrnt to 

RUM rPR]NT U0U1 
iihicli would be. an tri-or unless (her* usra 4 procedure, natied UOU. 

18.2 PROCEDURES DEFINING PROCEDURES 

[t is valid in LCGO to ^ave a pn-ocodura idhich define* another 

procedural 

TO DRIB 

IB TD D3AB 

29 10 PflLMr "UHCCPTE 

36 END 

END 

Running DP 1 3 cefipe& 'he &i-ocad\rB: 

TD CRAB 

IS PRINT 'LHOTPIE 

El* 

Natural lg. ue =an use RUN in ihit conteKk: 





TD DEFINE iPRPC ;N 
Iff RUN SE *T0 :Pfltt 

20 pun se tie rairm : w 

39 END 
END 


will cause 






DEFINE "WAnO 7 


to create 






10 PRINT 7 

END 



J tra MANUAL 7* 



In a sinilar nannnr, procEdurej n^y idi t propatfcirHfl-. 



13. miscellaneous oonrwras 

19.1 

BELL takes no inputs* Pings the bell an the console. 

CLUCK takes no inputs. Outputs a nunber Hhieh if intrfl-m?n tc-d every 
l/'EB seconds. 

[1ATE output* 3 2-e.lenent hit Containing Mnth, day h year. 

TIPE output* a 3-elenent Mat containing hour, *inute f second, 

WAIT takes one inpul f Causes LOGO to uai t Far that nany 1/30 
BGEond intervals. 

HELLO dear a out work apace | "restarts' LOCO for yOu< 

GQCCBVE sane as HELLB. 

LEVEL ta*es no inputs. Outputs a nuwber i*icn tells "how iiflnuj 
procedures deep 1, current execution 1 1+ 

PEEt fjrinta out gysteH statue inf ornat i on. 

F1A]L The HAIL connand enables users to send messages to Other USW* 
on LOGO. MAIL takes one input- the user name Iqtrtttdl of the parson to 
whom the wail is to be sent. The conputer responds tilth a baek-afrou. . (^) 
uhich indicate! thai anything typed in on the console is regarded as nail, 
To end the memag*, typo 3 I >ni with 3 single period fol lowed by a carriage 
rctu-n. The completed nsssage is (hen placed in the filing syalen of the 
user to uhorti it ie sent, contained in a file named FlAtL^ The mail tan he 
read either unen logging in h or by printing the (ile using the PDF cowhand, 
U is helpful to be logged in uh*n Sending Mill, dines the user's- login 
naiie is used to identify |h« sourci Of the *ai I to the person who receiver 
it. 



5EM3 takes tup in*iuti f Tht first pi the nunPer of a ton*ok. ern) 
the- &cc-0rtd is 3 list Mhich is printed out ag a nessage directly on that 
console. 

5Y5PP takfts at irj?ut a list which is printed out as a hessage on 
a I I consoles currently in udb. 

SfM takes ore nurtoer Lreprejenl; Ing degrees] as input and returns 
the smn of that angle, 

DOS takes, one input in degrees and output* the cosine of that 
angle. 

19.2 IMPUErEtlWJON DEPEIflENI PRlniTIYK 

Thf foM&ying are primitives MhlCtl refer specifically tn this 
i npler»entat inn of LOGO. 

*TVO take« two inputs. The firtt specifies a device. This may tie 
either 9 Oevice rubber or nane. The names that LOGO under stands for 
devices are: 

"LIGHT for Mm light box 

"Tim for turtle 1 

"TL&T2 for turtle 2 uh B n It is p-ugged in 

"lUSIC for the rrusic box 

"PLOTTER for the plotter 

■TTV fer you win console. 

The second input spec! fits 3 huhfcsr which is relayed to the given dt^ let as 
output. 

Til- ut:v ::.j- ::*.? -J ^h S fea*Ur« i* uith r e qa"d to tie light do*. 



. TVQing to a turtle is slightly useful* certain ce*ni3nds that can Lie done 
by the 1ui-tl* hirdui*-s have never oeen imjjl ononted rp LOGO gaftuarE [mainly 
because they are onl w w B r U si i ghtly useful 1 < Thm turthn can, for instance. 
uaddle instead of ualk* 
Try |hi* prco/aNr 

TO LJADCLE : STEPS 

10 IF ;STEPS - STOP 

20 ,TVD "TLfil » 

39 ,TV0 'TLR1 3S 

40 U*GDL£ : STEPS - 1 
EW 

The interested reader is referred to (he TURTLE GENERAL Engineer ing 

Handbook. Append i* 4 fpr more details* 

-TV] takes one input t#iich specifies 8 device in the sane manner 9$ 
. 1V\), The ie*t piece of i n t orma k i on (interpreted 3b 3 nimher t received 
Frtjm thq device 1b given as outputs 

.CLOSE It gov u&e +TT3 nr .TYO. LOGO assigns the device to you so 
that no one else e*n use if, Td release the dftvtce thfl .CLOSE conmand la- 
used, taking as its input the given device sped -Heat ion. 

.CTYI and .CTVQ are similar to + TY1 and .TYQ except that the 
specified device Is the user's console. .CTYLT takes one input,. <CTV] takes 
non*+ 

CTYQUA1T and TYflLlAlI 

These ca-nnands are a sped*! Ct WAIT cofcnand -- like IWUT EB — hut 
instead of waiting a fined amounl of tine, they ualt until a teletype has 
finished typing put. 

ft simple itM of CTVQJA[T is tp synchronize a procedure I hat drsuj 



on 'he display and 3 1 go pcinta atuff out. Euppoae you uish (a dray a PCLY 
dnd print tha turtle's heading at each corner. Nornally ih such a pro^r-am 
the displaying get a further ami further ahead of the printing. Butt 
CTVQJAH rill I twca the procedure to uait for the printing to tie conpleted 
before peing on; 

TO PQLV :SI0E :Al£ 

10 FCfiUARO ^IDE 

23 RIGHT jMJGie 

M PRINT HEADING 

43 CTVDI4A1T 19 !The rmiabcr it hou nuch tine Id uait in 

addition to siting for the teletype. 

50 POL^f ; 5 r DE :«JfJLE 

END 

TYOUA1T '^ I iKe CTYQUMTt except thai you specify uhiehi device to 
uait -for, TTtlUAlT understands: the 9-ane device nahes lhat , TYO and company 
under stand. It alED a^^epta telcl^r.e ngtitj«r3 t A good use for TYOUMT ie 
io synchronize the floor turtle uith the display turtle. 

,GUN tahea one input, a user ng&bet-. and res-tarta that user's LOGO' 
{*cju 5 talent to typing HELLD at his conagltL Thi* 1e used "hen someone' e 
ccnsJe gets hopelessly hung up. 

. CASE^tf On consoles equipped to handle Femer cafir., I Cinn normally 
converts cnaractars to upper caae. .CftSESU ie a eswiand which takes no 
input a and turns thia feature on and off. 

.ECHOSU laksfl no inpulsn Tumi of t and on a feature union inhibit* 
echoing of char act era typed it the con«l*+ 



20, I1AINLV FOR S^STBl PRDGflAITEnS 
Th« following primitives deal ui Ih the rtaintenanco and drty.jgg inej of 
The LOGO ftu,*t(i»* They: are uttelgl mainiy to ayaten p-og'-^tr-ncr^, 
. STF and + C1F set and clear a trace af the evaluatnr, 

.SGCF and .CDCF aet and clear a feature which chutes a garbage 

C0< led ion each line a node is all oca led, 
.SPNF and , CPfJF set and cl«ar printing the number of free nods a 

left when oarbage collections are run. 
.STATUS unlacfc protected contra-ids 
.PURCLR cto a reset ol the POP 11 and all devices. 

Nat to be used casual ly. 
,RUG halt LOCO and start The debugger 
.EETTV sot thft SyfltM tlae vgr iablea 
.GCOLL run a garbage collection* 
.EXAMINE alanine location, in FDP11 core* 
.OGPOSII deposit into car», 
.NODES output number oF free nodes. 
.VERSION output which version nt LOGO thin ii. 
.VALUE output the .ten an hop cf the S-POL. 
► UBRTlrE output the ahount o< user tin* MJP by the syaten. 



zi. tn iicex of logo pmntTivts 

Th# pages thai fol knu are a lilting of present LOGO priMltivee, 
wl|h tne exception of th* flprcial camanda MaLadi in Chapter 28. ft I ung 
ui |h each prinitive is th& folloHing i ti I or&at i arv: 

A9B, -- Aobreviat i ona and infi* I arm, \niix fern* ar» indicated by 

nr. 

MjrGCR OF If-^UIS-- The indication nV neana ths pnmiUs ti*u ubb tho 
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